Repository navigation
feat(patient): autoavaliação local no pilar A, sem sessão nem registro no servidor (C-11, #132) - #161
Conversation
… combinações (#132) SelfAssessmentEngine é a mesma árvore do TriageEngine, em Dart puro sem import. O teste de paridade do backend importa o arquivo do app e compara os dois motores nas 64 combinações em todo PR (job serverpod-backend).
…132) Botão na tela de entrada abre TriageScreen(local: true): sem accessToken, sem triage.evaluate e sem gravar respostas. O resultado diz que nada foi enviado; o vermelho abre a orientação "Ligar 192". Com sessão, nada muda.
| /// A tradução para [RiskLevel] é por **nome**, nunca por índice. | ||
| RiskLevel _evaluateOnDevice() { | ||
| final level = const SelfAssessmentEngine().evaluate( | ||
| chestPain: _answers[TriageSymptom.chestPain] ?? false, |
There was a problem hiding this comment.
Pedido. A paridade prova que o motor do aparelho é igual ao do backend, mas nada prova que a tela entrega a resposta certa a cada parâmetro. Conferi por mutação: trocando esta linha por chestPain: _answers[TriageSymptom.difficultyBreathing] ?? false,, a pessoa que responde só "dor no peito" recebe verde no modo local, e test/local_self_assessment_test.dart continua 5/5 verde. A amostra do teste 4 cobre só febre, vômitos e nenhum sinal; dor no peito, falta de ar e fraqueza nunca são respondidos sozinhos.
Como a INV-02 agora depende também desta ligação, peço um teste que responda cada sinal sozinho (mais "nenhum"; hoje faltam dor no peito, falta de ar e fraqueza, que nenhum teste responde isolados) e compare a saída da tela com SelfAssessmentEngine — o vermelho aparece como call_192_title, amarelo e verde como o rótulo do cartão. São sete execuções curtas e pegam qualquer resposta perdida ou trocada de classe. Se quiser ir além, as 64 combinações com o motor como oráculo também cabem num testWidgets.
|
|
||
| - **O que mudou.** A tela de entrada ganhou **Autoavaliação (sem cadastro)** (`LocalSelfAssessmentScreen`), que roda a árvore no aparelho por `SelfAssessmentEngine` (`apps/patient/lib/core/triage/self_assessment.dart`, Dart puro sem import): sem `accessToken`, sem rede, sem `triage_sessions`, sem gravar as respostas. O resultado local diz que nada foi enviado e troca "Acompanhar solicitação" por "Concluir"; o vermelho abre a orientação "Ligar 192" e grava o evento local (C-04). Com sessão (pilar B), nada muda: `triage.evaluate`. Backend sem mudança. | ||
| - **Paridade (INV-02 com dois motores).** `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart` importa o motor do app por caminho relativo e o compara com o `TriageEngine` nas 64 combinações, por nome do nível, e exige que as três saídas apareçam. Roda no `dart test` do job `serverpod-backend` (check obrigatório) em **todo** PR — o workflow não tem filtro de caminho, garantido por `ci_invariants.sh` —, seja qual for o motor alterado. Mutação conferida: tirar `bleeding` do vermelho do app reprova na combinação 16. Mover o arquivo do app quebra a compilação do teste, em vez de desligá-lo em silêncio. | ||
| - **Provas.** Paciente: `flutter analyze` sem avisos, 355 testes. `test/local_self_assessment_test.dart` (5) usa um backend que registra **qualquer** método chamado: nenhum na autoavaliação local; forçar o modo remoto na tela reprova 4 dos 5. Backend: `dart analyze` sem issue nova; o teste de paridade e o `triage_engine_test.dart` verdes. |
There was a problem hiding this comment.
Pedido. O CONTRIBUTING.md pede para não gravar contagens de testes nos documentos ("elas envelhecem a cada PR"). Sugiro tirar "355 testes", "(5)" e "4 dos 5" desta linha e deixar as contagens só no corpo da PR, por exemplo:
- Provas. Paciente:
flutter analyzesem avisos novos e suíte verde.test/local_self_assessment_test.dartusa um backend que registra qualquer método chamado: nenhum na autoavaliação local; forçar o modo remoto na tela reprova o teste. Backend:dart analyzesem issue nova; o teste de paridade e otriage_engine_test.dartverdes.
| // alcance daqui sem trazer o Flutter para o backend. O caminho relativo é o | ||
| // ponto do teste. | ||
| // ignore: avoid_relative_lib_imports | ||
| import '../../../../apps/patient/lib/core/triage/self_assessment.dart' as app; |
There was a problem hiding this comment.
Registro. Aprovo o import relativo: é o que permite ao job serverpod-backend compilar o motor do app sem trazer Flutter para o backend, e o comentário acima justifica o ignore. Conferi as duas pontas por mutação: tirar bleeding do vermelho no app reprova na combinação 16, e tirar persistentVomiting do amarelo no backend reprova na combinação 8. Fica registrado que mover ou renomear apps/patient/lib/core/triage/self_assessment.dart quebra a compilação deste teste — é o comportamento desejado, e quem mover o arquivo atualiza este caminho no mesmo PR.
|
|
||
| // As três saídas aparecem: uma árvore que devolvesse sempre o mesmo nível | ||
| // nos dois lados também seria "igual". | ||
| expect(seen, {'red', 'yellow', 'green'}); |
There was a problem hiding this comment.
Sugestão. A paridade não pode pegar uma mudança feita igual nos dois motores (é para isso que ela existe), e é justamente nesse caso que selfAssessmentEngineVersion tem de subir — senão o evento local "Ligar 192" passa a dizer arvore-v1 para uma regra que não é a v1. Uma forma barata de prender a versão, sem versão no backend: guardar a tabela das 64 saídas por versão e exigir que a versão corrente bata.
// Cada versão publicada da árvore e as 64 saídas dela (máscara 0..63; r/y/g).
const _arvores = {
'arvore-v1': 'grrryrrryrrryrrr' 'rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr',
};
test('a versão do motor corresponde à árvore em vigor', () {
final saidas = [
for (var mask = 0; mask < 64; mask++)
const TriageEngine().evaluate(/* mesmos seis bits do laço acima */).name[0],
].join();
expect(_arvores[app.selfAssessmentEngineVersion], saidas,
reason: 'a árvore mudou: suba selfAssessmentEngineVersion e acrescente a linha nova');
});Mudou a árvore sem subir a versão, o teste reprova; a troca da tabela fica visível no diff para quem revisa.
| ), | ||
| const SizedBox(height: 8), | ||
| Text( | ||
| 'Classificação feita pelo protocolo da equipe de saúde.', |
There was a problem hiding this comment.
Sugestão. No modo local esta frase continua aparecendo: "Classificação feita pelo protocolo da equipe de saúde." No pilar A não há equipe nem sessão, o projeto não tem vínculo com unidade de saúde, e o RF04 do piloto pede "nunca 'classificação de risco'". Como esta PR já troca a frase de orientação quando local é true, sugiro esconder esta também no modo local (ou trocar por algo como "Orientação educativa, calculada neste aparelho."). O texto final das saídas é da C-08 (#130); se preferir deixar para lá, basta citar esta frase na #130.
hbgit
left a comment
There was a problem hiding this comment.
Revisei a PR contra a issue #132, a INV-02 (determinismo da triagem, mesma entrada → mesmo resultado, nunca alterável) e a regra do escopo (pilar A sem conta e sem rede, RNF07/RNF09). Os três critérios de aceite estão atendidos:
| Critério da #132 | Evidência |
|---|---|
| Sem login, o resultado é o mesmo do motor do backend nas 64 combinações | backend/sinalacs_server/test/unit/self_assessment_parity_test.dart: laço mask 0..63, comparação por name (não por índice) e expect(seen, {'red','yellow','green'}) — dois motores constantes não passam. O segundo teste prende que os nomes de SelfAssessmentLevel e RiskLevel são os mesmos, o que protege o RiskLevel.values.byName da tela. A tela usa esse motor (_evaluateOnDevice, apps/patient/lib/app/app.dart:1632). |
| Nenhuma chamada de rede no pilar A | apps/patient/test/local_self_assessment_test.dart: _NetworkSentinel registra qualquer método de PatientBackend por noSuchMethod e lança; testes 1 e 3 afirmam a lista inalterada. PatientBackend é o único caminho de rede do app (grep por HttpClient/http/WebSocket/mqtt em apps/patient/lib: nada). |
| A paridade roda no CI a cada mudança de qualquer motor | .github/workflows/ci.yml:121: dart test sem filtro em backend/sinalacs_server, job serverpod-backend (check obrigatório), sem filtro de caminho (garantido por ci_invariants.sh). |
O que rodei em Linux (worktree limpo da branch, 15fd57b):
- Mutação 1, motor do app: tirar
bleedingdo vermelho emself_assessment.dart→dart test test/unit/self_assessment_parity_test.dartreprova (exit 1) na combinação 16,Expected: 'red' / Actual: 'green'. Revertido comgit checkout --. - Mutação 2, motor do backend: tirar
persistentVomitingdo amarelo emtriage_engine.dart→ reprova na combinação 8. Revertido. A paridade pega mudança dos dois lados. - Mutação 3, ligação da tela: em
_evaluateOnDevice, passar a resposta de falta de ar no lugar da de dor no peito →flutter test test/local_self_assessment_test.dartpassa (5/5). Revertido. Ver Inline 1. dart test test/unit/self_assessment_parity_test.dart test/unit/triage_engine_test.dart:+11: All tests passed!.dart analyzeno backend: 98 issues, nenhuma nos arquivos da PR (oignore: avoid_relative_lib_importsfunciona).- Paciente:
flutter analyzesó com o avisoasset_directory_does_not_existdeassets/certs/(diretório gitignorado, não é da PR);flutter testcompleto:+355: All tests passed!. bash scripts/qa/check_documentation_links.sh: só ographify-outausente emAGENTS.md, gitignorado, já assim antes.
Pontos que conferi e aprovo:
self_assessment.darté Dart puro, sem nenhumimport(sólibrary;), com a árvore idêntica à doTriageEnginelinha a linha; o comentário explica por que não pode importar nada.- No modo local, o único
BackendScope.ofdo_TriageScreenStatefica no ramofalsedo ternário;Call192OrientationScreentambém não lê oBackendScope(sóCall192Scope). Nada no modo local depende de servidor. - Resultado local: o texto diz que nada foi enviado e o botão é "Concluir" (teste 2 afirma também a ausência de "solicitação" e "entrará em contato"); o vermelho abre a orientação "Ligar 192" da C-04, grava
call192OrientationShowncomselfAssessmentEngineVersione recomeça do passo 1 sem guardar as respostas (teste 3). - INV-02 na tela: nenhum caminho altera o resultado —
_risksó é escrito com a saída do motor, não há campo editável, e o vermelho nunca vira cartão. - O
ignore: avoid_relative_lib_importsestá justificado em comentário, e mover o arquivo do app quebra a compilação do teste (o job fica vermelho, não verde em silêncio). AGENTS.mdeapps/CLAUDE.mdregistram a exceção à regra "sem regra de risco no cliente" e a obrigação de mudar os dois motores no mesmo PR comselfAssessmentEngineVersionnovo.spec/lgpd_design.mdcorrige a frase que dizia que a autoavaliação era enviada ao servidor.- Pilar B inalterado: o teste 5 prova que, com sessão, a triagem continua indo a
triage.evaluate.
Pedidos (nesta PR): teste da ligação respostas → motor (Inline 1); contagens fora do PROGRESS.md (Inline 2).
Sugestões (opcionais): prender selfAssessmentEngineVersion à tabela das 64 saídas (Inline 4); frase "Classificação feita pelo protocolo da equipe de saúde" no modo local (Inline 5); dois comentários de app.dart que ficaram desatualizados (Geral).
Registros: import relativo aprovado (Inline 3); o botão novo e os testes 2 e 5 precisam de ajuste quando a #156 e a #157 entrarem (Geral).
|
comentários desatualizados e convivência com a #156 e a #157 Comentários em
Convivência com a #156 e a #157 (registro, para quem fizer o rebase). O botão "Autoavaliação (sem cadastro)" entra no mesmo bloco da tela de entrada em que a #156 acrescenta "Biblioteca de saúde (sem cadastro)" (
|
app.dart: botão de autoavaliação ao lado do botão da biblioteca (C-03) no bloco de credenciais. PROGRESS.md: mantém as seções novas.
Closes #132
C-11 (RF04, RF16, RF22, RNF09): no pilar A a autoavaliação roda no aparelho, sem
accessTokene sem gravar emtriage_sessions. A chamada remota fica só no pilar B, com sessão.O que muda
SelfAssessmentEngineemapps/patient/lib/core/triage/self_assessment.darté a mesma árvore doTriageEngine.RiskLevelpor nome, nunca por índice.TriageScreen(local: true), que nunca lê oBackendScope.triage.evaluate.Paridade no CI (terceiro critério)
backend/sinalacs_server/test/unit/self_assessment_parity_test.dartimporta o motor do app por caminho relativo e o compara com oTriageEnginenas 64 combinações.dart testdo jobserverpod-backend, que é check obrigatório, em todo PR, qualquer que seja o motor alterado. Oci.ymlnão tem filtro de caminho, e oci_invariants.shimpede que ganhe um.bleedingdo vermelho no motor do app reprova o teste na combinação 16.avoid_relative_lib_importsdo import ficou comignorejustificado. Odart analyzedo backend continua com as mesmas 98 infos dadevelop, nenhuma nova.Critérios de aceite
test/local_self_assessment_test.dartusa um backend que registra qualquer método chamado; forçar o modo remoto na tela reprova 4 dos 5 testes.Como testar
Docs
AGENTS.mdeapps/CLAUDE.md: os dois diziam que o app não pode ter regra de risco no cliente. Agora registram a exceção da C-11 e a regra de mudar os dois motores no mesmo PR, subindoselfAssessmentEngineVersion.spec/requisitos_piloto.md(RF04),spec/lgpd_design.md§0,docs/telas-paciente.mdePROGRESS.md.Fora deste PR
selfAssessmentEngineVersionestá documentada, mas não é testada, porque o backend não tem versão de motor.